package com.nari.ncps.screen.mapper.dryport;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.nari.ncps.screen.entity.dryport.DryportProdoperPortGather;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * <p>
 * 集港量情况表 Mapper 接口
 * </p>
 *
 * @author xuesong
 * @since 2025-08-23
 */
public interface DryportProdoperPortGatherMapper extends BaseMapper<DryportProdoperPortGather> {

    /**
     * 根据年份查询月度统计数据
     * @param year 年份
     * @return 月度统计数据列表
     */
    List<DryportProdoperPortGather> getMonthlyStatsByYear(@Param("year") Integer year);

    /**
     * 查询年度汇总数据（最近5年）
     * @return 年度汇总数据列表
     */
    List<DryportProdoperPortGather> getAnnualStats();

    /**
     * 获取最近12个月的统计数据（按月份从小到大排序）
     * @return 最近12个月的统计数据列表
     */
    List<DryportProdoperPortGather> getLatest12MonthsStats();

}
